\name{link}
\alias{link}
%- Also NEED an '\alias' for EACH other topic documented here.
\title{Link}
\description{
Link various graphical features and components together and generates a DotStack object.
}
\usage{
link(x, h, color, shape = NULL)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
  \item{x}{\code{x} the variable name to be linked as the actual data.
}
  \item{h}{\code{h} a parameter specifying the desired dot size (radius).  It defaults to \eqn{n^{-\frac{1}{2}}}{n^(-1/2)} if unset.

}
  \item{color}{\code{color} is the colour(s) for the dots.  If it is a variable name, it is assumed to be equal to the length of \code{x}.  It can also be a single value (e.g., "black", "blue", etc.) as long as it is one of the valid R colors.  For help findning a valid color, see \code{\link{ColorViewer}} and \code{\link{colors}}.
}
  \item{shape}{The \code{shape} argument is not currently implemented, but planned in a future release.
}
}
\details{\code{link} is primarily meant to be called within \code{StackedDots} to help with mapping variable names to different graphical parameters and generating a DotStack object.
}
\value{
  An object of class \code{DotStack}.
}
%% \references{}
\author{Joshua Wiley, \url{http://joshuawiley.com/}}

\note{Hopefully this will be getting expanded and improved to have more useful features in the near future.}

\seealso{\code{\link{StackedDots}}
}
\examples{
## None, see StackedDots
}
% Add one or more standard keywords, see file 'KEYWORDS' in the
% R documentation directory.
\keyword{dplot}
